home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / bbs / sam_v12.exe / SAM.DOC < prev    next >
Text File  |  1992-12-02  |  12KB  |  270 lines
  1.    Slickware is Copy(c)right 1989,1992 by Gary M. Raymond, New Orleans, La.
  2.               Slick Answer Machine Program V1.2 by Gary M. Raymond
  3.  
  4.                           Simple <Software> Company
  5.                               HOME of SlickWare
  6.  
  7.                               Gary M. Raymond
  8.                                 P.O.Box 8184
  9.                            New Orleans, La.  70182
  10.                                (504) 288-6550
  11.                             Compuserve 70613,3165
  12.  
  13.    ====================================================================
  14.  
  15.    Files Provided:
  16.    SAM.COM        Slick Answer Machine
  17.    SAM.DOC        This document.
  18.    SAM.TXT        Hello text file (sent to logon)
  19.    SAM.CFG        Modem Initialization string file
  20.    SAMRUN.BAT     Batch for running external application
  21.  
  22.  
  23.    Why SAM?  SAM is intended to do two things.
  24.  
  25.    First, to provide a simple way to inform your users when your BBS or
  26.    other system is temporarily off line.
  27.  
  28.    Second, to provide a doorway to DOS so you can access your operating
  29.    system remotely or load and run a modem software game or other similar
  30.    application. CAUTION: If you use it to drop to dos, be aware that
  31.    unless you are running a product line DOORWAY (that provides password
  32.    protection) anyone knowing your routine could gain access as well.
  33.  
  34.    Running SAM, without a parameter, will provide this help info:
  35.    ====================================================================
  36.    The Correct Syntax is SAM #  (i.e. SAM 1)"
  37.  
  38.    1 = COM1,2400b,8N1"
  39.    2 = COM2,2400b,8N1"
  40.    3 = COM3,2400b,8N1"
  41.    4 = COM4,2400b,8N1"
  42.  
  43.    If the port is active, you will see an OK"
  44.    immediately following the setup string."
  45.    ====================================================================
  46.  
  47.    What makes SAM a very useful and easy to use program is its
  48.    simplicity yet abundant versatility. SAM was written in ASIC. A "C"
  49.    constructed compiler that produces clean, tight, fast code modules.
  50.    The general makeup of the serial portions of the code involve polling
  51.    the UART port. To avoid most of the pitfalls in using BIOS services
  52.    to find port addresses, direct addressing is also used. The only
  53.    limit here is in having to choose the STANDARD or IBM default
  54.    addresses of 3F8, 2F8, 3E8, 2E8 for port 1 through 4 respectively.
  55.    Also, to keep it even simpler, all ports are set up for 2400 baud at
  56.    8 data bits, No parity, and 1 stopbit. Upon registration, I will send
  57.    you a version set to what ever baud rate you prefer.
  58.  
  59.    All files must reside in the same directory. If SAM cannot locate
  60.    a required file, it will inform you with these messages:
  61.  
  62.        SAM incapable of loading! File"
  63.        missing (SAM.CFG), Recheck!"
  64.  
  65.        SAM incapable of loading! File"
  66.        missing (SAM.TXT), Recheck!"
  67.  
  68.    In either case, SAM will return you to the system prompt for further
  69.    investigation.
  70.  
  71.    Perhaps the most critical part is the modem string that should be
  72.    placed in the SAM.CFG file. Lets take a moment to examine it switch
  73.    by switch:
  74.  
  75.    ATV0M1&D2X1S0=1S7=45
  76.  
  77.    AT    = modem attention command
  78.    V0    = have modem give numeric command replies (verrry important)
  79.    M1    = turn speaker off after connect
  80.    &D2   = allow software control of data line (wont hangup otherwise)
  81.    X1    = allow standard command replies
  82.    S0=1  = set to answer phone on first ring (you may change this)
  83.    S7=45 = hangup if no carrier in 45 seconds
  84.  
  85.    If any ONE switch is invalid for your brand of modem, the entire
  86.    string will fail resulting in the following message:
  87.  
  88.        ERROR
  89.        Check Modem Initialization string!"
  90.  
  91.    The quickest way to test each switch is to type it in terminal mode
  92.    using your favorite comm program and see if they echo OK. Remember,
  93.    each switch must be preceded by AT. (ATM1 etc)
  94.  
  95.    If the port you select is inoperative, you will get the following
  96.    message:
  97.  
  98.        Your Modem is NOT echoing OK!. Suggest you"
  99.        ensure you are using the active com port!"
  100.  
  101.    You cannot use the same port your mouse is connected to. For that
  102.    matter, you cannot use any serial port that is already dedicated
  103.    to another device. (light pen, mouse, digitizer etc.)
  104.  
  105.  
  106.    SAM.TXT (as supplied)
  107.    ====================================================================
  108.            Greetings Logon!
  109.  
  110.            You have reached our On-Line
  111.            Service. Unfortunately we are
  112.            OFF-LINE for regular maintenance.
  113.            Please try again in 12 hours.
  114.  
  115.            Best Regards
  116.            SYSOP
  117.    ====================================================================
  118.    You may alter this message file to suit your needs. I suggest keeping
  119.    it short and sweet. I also suggest having at least two blank lines
  120.    before text begins to allow a few carriage return, linefeeds to first
  121.    clear the modem.
  122.  
  123.  
  124.    SAMRUN.BAT
  125.    ====================================================================
  126.    DROPDOS.BAT
  127.    ====================================================================
  128.    You will note that SAMRUN.BAT is running another batch file called
  129.    DROPDOS.BAT. This is just a matter of convience as the content of
  130.    DROPDOS could well be contained in SAMRUN. If there is no SAMRUN.BAT
  131.    or it is empty, SAM will simple recycle after the SAM.TXT message.
  132.    Similarily, if SAM.TXT is empty, no message is first transmitted
  133.    and SAM immediately loads SAMRUN.BAT. This provides a lot of
  134.    versatility.
  135.  
  136.    ====================================================================
  137.    (method of dropping to DOS)
  138.    DROPDOS.BAT
  139.    @ECHO OFF
  140.    CTTY COM2:                    (set this to com port in use)
  141.    C:\COMMAND.COM                (path to command processor)
  142.    CTTY CON
  143.  
  144.    Personally, I would suggest you use DOORWAY or GATEWAY. In some
  145.    cases (because of problems with redirection and the CTTY dos
  146.    command) you really have no choice.
  147.  
  148.    ====================================================================
  149.  
  150.  
  151.  
  152.  
  153.  
  154.    Finally, if all is well, you will see the following message, indicating
  155.    SAM is ready to answer the phone........
  156.  
  157.         Accessing COM2!
  158.         Hit <Esc> to Exit!"
  159.         ATV0M1&D2X1S0=1S7=45
  160.  
  161.         OK
  162.  
  163.    CAVEAT: When there is a problem with computer hardware or software,
  164.    there is always an answer lurking somewhere. Using serial devices
  165.    and software, is one of the more perplexing aspects of this axiom.
  166.    Unfortunately, sometimes the answer turns out to be the dirty word
  167.    "incompatible". However, the simplicity of SAM almost insures that
  168.    it will work on even the weirdest of iron (modems). To that end, I
  169.    have coded all critical timing aspects to be independent of CPU speed
  170.    as well, so as to allow SAM to run on processors from 4.77 to 60mhz.
  171.    This built in constraint (as see by the modem string slowly echoing
  172.    on the screen) is a necessary evil to ensure the widest compatibility.
  173.  
  174.    ====================================================================
  175.    SAM V1.2  12/01/92  Bug fix when using COM4 (2E8,IRQ3)
  176.  
  177.    SAM V1.1  11/01/92  First release
  178.    ====================================================================
  179.  
  180.                            ┌─────────┐
  181.                            │ MEMBER  │   Society of
  182.                            │  ┌──────┴──┐ Independent
  183.                            │  │         │   Shareware
  184.                            └──┤    ■    │     Authors
  185.                               │    ║    │
  186.                               └────╨────┘
  187.     This program is produced by a member of the Society of Independent
  188.     Shareware Authors (SISA). The Society wants to ensure that all
  189.     valid shareware principle actually work for you and SISA members.
  190.     The principle behind shareware distribution is simple; try before
  191.     you buy. Society members agree to license all shareware for a minimum
  192.     of 10 days, free of charge, to first time users as an evaluation period.
  193.     After 10 days, buyers are then obligated to license their copy with
  194.     the Society member. Society members are obligated to provide high
  195.     quality, useful shareware, but, are free to choose whatever marketing
  196.     methods suit their specific needs. SISA sanctioned marketing methods
  197.     include: demonstration versions; providing printed documentation
  198.     after purchase; registration keys that unlock additional features
  199.     not necessary to determine basic usefulness; and, providing bug
  200.     fixes free of charge. Any Shareware author may become a member of
  201.     SISA without cost by simply agreeing to the above conditions and
  202.     displaying, at their option, this logo in their documentation.
  203.    ====================================================================
  204.  
  205.     WARRANTY:
  206.     Software:
  207.     Simple Software warrants that the software contained herein will
  208.     perform in substantial compliance with the documentation
  209.     accompanying the software. If you report, in writing, a significant
  210.     defect to us, and we are unable to correct it within 90 days of the
  211.     date you report the defect, you may return the software and
  212.     accompanying materials, and we will refund the purchase price.
  213.  
  214.     Diskette's and Documentation:
  215.     Simple Software, warrants all diskette's and documentation to be
  216.     free of defects in materials for a period of 30 days from the date
  217.     of purchase. In the event of notification within the warranty period
  218.     of defects in any materials, Simple Software will replace the
  219.     defective diskette or documentation.
  220.  
  221.     Remedies:
  222.     The remedy for breach of the warranty shall be limited to
  223.     replacement and shall not encompass any other damages, including but
  224.     not limited to loss of profit, special, incidental, consequential,
  225.     or similar damages, losses, or claims.
  226.  
  227.     DISCLAIMER:
  228.     Simple Software specifically disclaims all other warranties,
  229.     expressed or implied, including but not limited to, implied
  230.     warranties of merchantability and fitness for a particular purpose
  231.     with respect to defects in the diskette and documentation, and the
  232.     program license granted herein, in particular, and without limiting
  233.     operation of the program license with respect to any particular
  234.     application, use, or purpose.  In no event shall Simple Software be
  235.     liable for any loss of profit or any other commercial damage,
  236.     including but not limited to special, incidental, consequential or
  237.     other damages.
  238.  
  239.     GOVERNING LAW:
  240.     This statement shall be construed, interpreted, and governed by the
  241.     laws of the State of Louisiana.
  242.     ====================================================================
  243.  
  244.    Registering your copy will help continue the competitive advantages
  245.    of providing economical shareware. You will be sent the latest
  246.    version and automatically notified of all upgrades and bug fixes.
  247.  
  248.    Yes Gary, I enjoy your program and would like to register and
  249.    obtain the latest version.
  250.  
  251.  
  252.    Name_____________________________________________________________
  253.  
  254.    Mailing Address__________________________________________________
  255.  
  256.    City & State ___________________________________________________
  257.  
  258.    ZIP _____________________________ Phone _________________________
  259.  
  260.    Send $9 + $1 (ship & hand) check or money order to:
  261.  
  262.                               Gary M. Raymond
  263.                                 P.O.Box 8184
  264.                             New Orleans, La. 70182
  265.                                 504-288-6550
  266.                             Compuserve 70613,3165
  267.    ====================================================================
  268.                                      EOF
  269.  
  270.